home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / cshark52.zip / CS.DOC < prev    next >
Text File  |  1992-11-11  |  22KB  |  532 lines
  1. ╔═════════════════════════════════════════════════════════════════════════════╗
  2. ║                                                                             ║
  3. ║                 Corporate Headquarters BBS (815) 886-3233                   ║
  4. ║                                            (815) 886-9381                   ║
  5. ║                                                                             ║
  6. ║                            C A R D   S H A R K S                            ║
  7. ║                                    v5.2                                     ║
  8. ║                                                                             ║
  9. ║                              MULTI-BBS Support                              ║
  10. ║       Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire, WWIV,        ║
  11. ║                UltraBBS, Telegard, TriTel, and Remote Access                ║
  12. ║                                                                             ║
  13. ║                               Copyright 1992                                ║
  14. ║                               by Robert Neal                                ║
  15. ║                             317 Hickory Avenue                              ║
  16. ║                            Romeoville, IL  60441                            ║
  17. ║                                                                             ║
  18. ╚═════════════════════════════════════════════════════════════════════════════╝
  19.  
  20. |Changes to this documentation file from the previous version are
  21. |indicated by "|" in the left hand margin. This should make finding
  22. |changes to the documentation much easier and faster for those upgrading
  23. |from previous versions.
  24.  
  25. |ATTENTION: Beginning with v5.0, the program incorporates new routines.
  26. |Those upgrading from a prior release should note the new format for the
  27. |configuration file. With these changes, the file BRUN45.EXE is no longer
  28. |needed.
  29.  
  30. Card Sharks is released as SHAREWARE. You are granted a limited license to
  31. evaluate the program. Try it out, if you continue to use it you are required
  32. to register the program.
  33.  
  34. To register the program send $15.00 along with your name and BBS phone # to:
  35. Robert Neal, 317 Hickory Avenue, Romeoville, IL 60441.
  36.  
  37. The file CS.REG contained with this package must not be altered in anyway.
  38. Doing so will result in the program failing to operate. Once you register 
  39. the program you will be given your own personalized CS.REG file which will 
  40. show that the program is registered. BBS name supplied with payment will
  41. be the name 'imprinted' in the CS.REG file.
  42.  
  43.  
  44. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  45. CHARGE AND WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  46. LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  47. PARTICULAR PURPOSE.  IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND
  48. PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL
  49. DAMAGES, ARISING OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  50.  
  51.  
  52. Card Sharks is based on the TV show of the same name with some minor 
  53. variations. Each time the player is started with $200 to wager. He may
  54. bet any amount he desires up to the amount in his bank. The rules of play
  55. are pretty self explanitory and are displayed in the new player information
  56. screen of the game itself therefore I will not cover them here.
  57.  
  58. In addition to the initial $200 bank, for each row the player advances
  59. he is given another $200. On the last row the player is given the chance to
  60. bet his winnings from the current game PLUS the winnings he started the 
  61. game with in his bankroll.  The player must then bet atleast half of his
  62. entire bank on the last row (and last card). Note that the player is only
  63. given $200 each time he starts the game, he is not given his entire bankroll
  64. to play the game, only for the final card.
  65.  
  66. On the final card, if the user hangs up without placing a wager on the top
  67. card, the program will automatically take half of his bankroll. I've seen
  68. where some users, in an attempt to play it safe, will hang up rather than
  69. play out the last card (especially if it's an 7, 8, etc.). This should keep
  70. the game more honest for everyone.
  71.  
  72.  
  73.  
  74. FEATURES OF CARD SHARKS
  75.  
  76.   -  Easy to install and requires no maintenance.
  77.  
  78.   -  Ansi color support.
  79.  
  80.   -  Terminates cleanly through exit code even on runtime error.
  81.  
  82.   -  Automatically creates a top score listing suitable for inclusion
  83.      as a text/bulletin file for display within your BBS. 
  84.  
  85.   -  Detects loss of carrier.
  86.  
  87.   -  Operates in local mode (either direct from BBS or from command line).
  88.  
  89.   -  Sysop function keys to return to the board, chat mode, user stats,
  90.      increase/decrease time, etc.
  91.  
  92.   -  Direct support for PCBoard, WildCat!, Gap, QBBS, RBBS, WWIV,
  93.      Ultra BBS, Telegard, TriTel and Remote Access.
  94.  
  95.   -  Support for baud rates up to 115,200
  96.  
  97.   -  Support for COM1-4. Optional command line for non-standard IRQ's.
  98.  
  99.   -  Supports PCBoard environment variables %PCBDRIVE% and %PCBDIR%
  100.  
  101. | -  Support Fossil Drivers. A Fossil driver is not required to use the
  102.      program.
  103.  
  104.   -  Fully Multi-Node compatible.
  105.  
  106.  
  107.  
  108.  
  109. FIRST TIME OPERATIONS
  110.  
  111. If you are setting up a game for the first time you MUST pass the command
  112. parameter "NEW" to the program so that it will create the necessary files,
  113. ie. CS NEW. This is the only time that you need to pass this parameter,
  114. but you may use it to restart a game before the monthly maintenance. Note
  115. that passing the 'NEW' parameter will NOT cause the current high score file
  116. TOP5.RPT to be converted to the  TOP5.OLD file.
  117.  
  118. The 'NEW' will wipe out all current files, so be sure you want to 'NEW'
  119. the game before using it.
  120.  
  121.  
  122.  
  123.  
  124. AUTOMATIC MAINTENANCE
  125.  
  126. The program will automatically during the first play of each new month
  127. reset it's user file and top score listing. The previous months top score
  128. listing (TOP5.RPT) will automatically be renamed to TOP5.OLD. This  can then
  129. be included as a text file to display the previous months winners.
  130.  
  131. You should be aware of this so if you are starting a new game for the
  132. first time towards the end of the month, the game will automatically perform
  133. the maintenace come the first of the month.
  134.  
  135.  
  136.  
  137. CONFIGURING THE PROGRAM
  138.  
  139. |New with v5.1 is a program called CSCONFIG.EXE. You may use this program
  140. |to create and/or edit the configuration files. To use CSCONFIG, type
  141. |CSCONFIG CS.CFG. This editor will allow you to enter the appropriate
  142. configuration editor within it's own full screen editor as well as edit
  143. the CS.TXT file. Below is the layout of the CS.CFG file if you wish to
  144. edit it manually.
  145.  
  146. C:\PCB\PCBOARD.SYS
  147. Corporate Headquarters
  148. Bob
  149. Neal
  150. 3
  151. 100
  152. NOBANKRUPT
  153.  
  154. Line 1 = Full pathname of your door file. Formats supported by this
  155.          program are: PCBOARD.SYS, USERS.SYS, DOOR.SYS, USERINFO.DAT,
  156.                       CALLINFO.BBS, DORINFOx.DEF, SFDOORS.DAT and
  157.                       CHAIN.TXT. When using USERINFO.DAT, DOOR.SYS
  158.                       must be in the same directory as USERINFO.DAT.
  159. Line 2 = BBS name
  160. Line 3 = Sysop First Name
  161. Line 4 = Sysop Last Name
  162. Line 5 = number of times per day that a player may play the game
  163.          if you do not wish to limit the number of daily plays enter
  164.          a large number (999 for example). I would suggest the a daily
  165.          limit be used (3 is a good number to use) so as to prevent
  166.          some users from running up the scores.
  167. Line 6 = Probability of a Joker being added to the deck. This is a new
  168.          option in v5.1. Enter 100 if you want 1 joker added (100%
  169.          probablility), enter 200 for 2 jokers or you may enter 50 to
  170.          have a 50% probability that a joker would be hit. Do not set
  171.          this value to high otherwise the users may get tired of
  172.          seeing the joker pop up. I recommend a value between 50-100.
  173. Line 7 = Another new feature with v5.1. You can set the option to either
  174.          bankrupt the player (the entire bankroll is lost) or just the
  175.          turns remaining for that day if the joker is hit. Enter either
  176.          BANKRUPT or NOBANKRUPT - I recommend NOBANKRUPT.
  177.  
  178.  
  179.  
  180. Note: This door supports the PCBoard environment variables %PCBDRIVE%
  181. and %PCBDIR%. Non-PCBoard systems may also use these variables by
  182. including the following either in your BBS batch or AUTOEXEC.BAT file:
  183.  
  184.     SET PCBDRIVE=C:            <- Drive letter of your BBS files
  185.     SET PCBDIR=\BBS            <- Path of your BBS files
  186.  
  187. Then, in your CS.CFG file, on the first line you may put:
  188.  
  189.    %PCBDRIVE%%PCBDIR%\PCBOARD.SYS, %PCBDRIVE%%PCBDIR%\DOOR.SYS, etc.
  190.  
  191. This allows you to use just one .CFG file for multi-node operation.
  192.  
  193.  
  194.  
  195. EXECUTING PROGRAM
  196.  
  197. To execute the program, enter the filename followed by the config file
  198. name (ie CS.EXE CS.CFG). If you are running the program from the command
  199. line, you may optionally enter CS.EXE LOCAL. The only problem with this
  200. is the default user name sysop is used instead of the name on your board.
  201. This is good for testing the game before putting it on your system, but
  202. you should once play begins, execute the program locally from your BBS or
  203. consistantly run the game from the command line when you play.
  204.  
  205. You may also specify a non-standard IRQ. Put the IRQ number after the
  206. .CFG on the command line. For example: CS CS.CFG /5. This example tells
  207. the program to use IRQ 5 instead of the standard IRQ.
  208.  
  209. You may also use the procedure above and create a variable IRQ so that
  210. you can pass the IRQ setting as: CS CS.CFG /%IRQ%
  211.  
  212. |Some users may have had conflicts when using non-standard IRQ's on
  213. |Novell/Netware systems. Novell seems to use the "/" character for
  214. |parameter passing. You may not optionally use the "*" character instead
  215. |of the "/", for example CS CS.CFG *%IRQ% is valid. Both "*" and "/"
  216. |will work.
  217.  
  218.  
  219. You also have the option of running the game as 'stand alone' (without a
  220. BBS). To do so, type CS.EXE NOBBS. You will now be prompted to enter
  221. your name. This is useful for testing the program offline for sysops and
  222. have had people find this useful to play as a non-BBS door.
  223.  
  224. |FOSSIL DRIVER
  225. |=============
  226. |
  227. |Card Sharks now includes support for FOSSIL drivers. This means that the
  228. |program will now work with Digiboard (for Wildcat M and PCBoard/M
  229. |versions) and other multi-port boards. To activate the Fossil driver
  230. |support just include /FD on the command line in your door batch file.
  231. |
  232. |        For example: CS CS.CFG /FD
  233. |
  234. |If no Fossil driver is available, Card Sharks will display a message
  235. |indicating such and exit cleanly.
  236.  
  237.  
  238.  
  239. This documentation will not go into the mechanics of how you set-up a door
  240. program on your BBS. It is assumed that you have a working knowledge of
  241. how to complete this task.
  242.  
  243.  
  244. SYSOP KEYS ACTIVE
  245.  
  246. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  247.          written to DOOR.SYS and USERS.SYS
  248. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  249.          and/or written to DOOR.SYS and USERS.SYS
  250. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  251. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  252.          and/or written to DOOR.SYS and USERS.SYS
  253. F8    -  Returns the caller involuntarily to the BBS.
  254. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  255.          and/or written to DOOR.SYS and USERS.SYS
  256. F10   -  Activates SysOp CHAT mode within the DOOR.
  257. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  258. UP    -  Give the caller extra time while in the DOOR.  
  259. DN    -  Subtract time from the caller while in the DOOR. 
  260. HOME  -  HELP key for Status Line options.
  261. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  262. ALT-X -  PCBoard will exit after current caller logs off. Value is
  263.          passed to PCBoard. Not available on non-PCBoard systems.
  264.  
  265.  
  266.  
  267.  
  268. FILES USED AND CREATED
  269.  
  270. CS.EXE - The program itself (may want to rename to CS.EXE)
  271. CS.DOC  - Documentation for the sysop to run Card Sharks
  272. CS.REG   - File which shows who 'owns' (registered) the game
  273.            MUST NOT BE ALTERED
  274. CS.CFG   - Configuration file
  275. CS.TXT   - Option text file with comments for winning and losing. This
  276.            file will only be read by REGISTERED versions of Card Sharks.
  277.  
  278.  
  279. The following files will be created by Card Sharks
  280.  
  281. CARDSHRK.USR - User file of current players
  282. TOP5.RPT     - Top 5 scores in ascii format can be used as a bulletin
  283. TOP5.CS      - Top 5 socres data file
  284. TOP5.OLD     - Previous months score listing, created at the beginning of
  285.                each new month
  286. HISCORE.CS   - Data file with name and amount of highest earnings ever.
  287.  
  288.  
  289. THE GAME ITSELF
  290.  
  291. The game starts by displaying the Card Sharks opening screen (please do not
  292. modify this or any other part of the game), and will ask the user if he 
  293. wants to use ANSI colors. While the BBS door info file passes the variable for
  294. if a user has ANSI on or off, this gives those players a chance who may have
  295. ANSI off for normal BBS useage to use ANSI colors while in the door.
  296.  
  297. From here, if the player is a new player he is informed of the rules of play
  298. and his account in established. If he is a current player he will be shown
  299. his player stats right away (last time on, bankroll, etc) and then play
  300. will begin. The users stats are updated after each guess (right or wrong)
  301. so as to prevent callers from disconnecting if the hit bankrupt on a bad
  302. guess.
  303.  
  304. Play continues until the players bank account hits zero or the last card 
  305. is played.  The top score listing is then updated with the new standings.
  306.  
  307.  
  308.  
  309. CONTACT ME FOR SUPPORT
  310.  
  311. If you encounter any problems you may contact me at Corporate Headquarters
  312. BBS (815) 886-3233 or (815) 886-9381.
  313.  
  314. If you have any suggestions for improvements for this program, please feel
  315. free to let me know. This game has included suggestions from users of my
  316. BBS as well as the beta testing BBS.
  317.  
  318.  
  319.  
  320. VERSION HISTORY
  321.  
  322.  
  323. Version 3.0 (02/15/89)
  324.  
  325. While Card Sharks has been available for play on my BBS for over a year,
  326. this is the first attempt at releasing a completely standalone program for
  327. others use.
  328.  
  329.  
  330. Version 3.1 (03/01/89)
  331.  
  332. Fixed several bugs including a problem with the program in rolling over
  333. the previous months scores. The game would rollover the scores fine the
  334. first month, but subsequent rollovers caused the game to go into a 
  335. screeching halt. With this fix also comes improved error handling so that
  336. if something else quirky does arise the program will exit gracefully back
  337. to the BBS instead of just dieing.
  338.  
  339. Fixed a minor problem with the input of using 'H'alf of bank. If a person
  340. had only $1 the program would round the bet down to zero. Now if the person
  341. has only $1 left to wager, half the bet would be the $1 remaining.
  342.  
  343. Added a new file CS.REG which contains information on whom the program is
  344. registered. Unregistered programs are given the default file that labels
  345. the program as being unregistered. Failure to keep this program in the
  346. same directory as the Card Sharks program itself or altering this file
  347. will result in the game refusing to operate. This 'feature' makes it 
  348. very simple for me to pass along a registered 'copy' to those who register
  349. as all I need to do is hand out their own personalized CS.REG file.
  350.  
  351.  
  352.  
  353. Version 3.2  (05/05/89)
  354.  
  355. Once again the problem with the previous months scoreboard rolling over
  356. has appeared. Seems that the problem only occurs when a remote call is
  357. the first call of the month. If the sysop was the first call (locally)
  358. the rollover worked fine. I have once again reworked the code and hope
  359. this is the final time to call out the pest control for this problem.
  360.  
  361. Changed the program so that the sysop must now pass the parameter 'new'
  362. to initialize a new game. Passing the parameter 'NEW', ie. CS NEW,
  363. will cause the game to create new data files for the game. 
  364.  
  365. Also added some more color to the game by now displaying the card numbers
  366. and suites in a different color than the card itself.
  367.  
  368.  
  369. Version 3.3  (06/01/89)
  370.  
  371. The bug with the rollover still managed to appear, but this time it's
  372. next to guaranteed that the monthly score rollovers will work without
  373. fail. A conflict between my code and the CatPatch routines made it
  374. difficult to uncover. This function has now been tested and retested to
  375. ensure proper handling of the routine.
  376.  
  377. Expanded the scoreboard field to allow well over a ZILLION points to be
  378. displayed. Yes, it happened, a real duel was underway with two players
  379. rolling their scores into the zillions on my board.
  380.  
  381.  
  382.  
  383. Version 4.0  (09/22/89)
  384.  
  385. First off, there have been no problems reported with the monthly rollover
  386. of the scoreboard. Told you is was nearly guaranteed that it would work
  387. properly this time.
  388.  
  389. Added option to run as a non-BBS program (stand alone).
  390.  
  391. Enhanced the display to show actual suit cards (a club, heart, spade
  392. and diamond) instead of 'C', 'H','S' and 'D' respectively if the user
  393. selects ANSI graphics display.
  394.  
  395. Added multi-BBS support to allow Card Sharks to be run on PCBoard v14.x,
  396. QBBS, RBBS 15.1c and of course Wildcat.
  397.  
  398. Recoded the card display option to update only the card changed. Previously
  399. if a user changed the card after jumping to the next row the last card
  400. on the previous row was also changed.
  401.  
  402. Found that some users would rather hang up after seeing the top card rather
  403. than take a chance of loosing half their bankroll. Well that has now been
  404. fixed in this version as the program will automatically take half their
  405. bankroll if they decide to hang up instead of playing the card shown.
  406.  
  407. For those who are upgrading to the new version, you need not change anything
  408. you now have set-up. Just copy the CS40.EXE file into the proper directory.
  409.  
  410.  
  411. Version 4.1 (04/28/90)
  412.  
  413. Added support for WWIV (CHAIN.TXT) file format.
  414.  
  415. Revised scoreboard to include highest ever earnings in Card Sharks as
  416. well as average earnings per play.
  417.  
  418. Added option where user can remain in door and play out as many turns
  419. as he has left. For example if you allow 3 plays per day, the user no
  420. longer is forced to return to the board after each play. If he has 1 or
  421. more turns left for the day he is prompted if he wants to play another
  422. round.
  423.  
  424. Again, if upgrading just copy the CS41.EXE file into the proper
  425. directory.
  426.  
  427.  
  428. Version 4.2 (Added support for Spitfire BBS)
  429.  
  430.  
  431. Version 4.3 (08/13/90)
  432.  
  433. Limited release version for beta testing new routines for high speed HST
  434. modems.
  435.  
  436.  
  437. Version 4.4 (08/25/90)
  438.  
  439. Resolved problem with high speed modems (9600+ baud). Beta testers have
  440. reported that program now operates fine at high speed modes.
  441.  
  442. Changed compiler to latest version, v4.5 of Quick Basic. Program now
  443. requires use of patch BRUN45.EXE program. Program is distributed with
  444. this program.
  445.  
  446.  
  447. v4.5
  448.  
  449. Internal version, minor changes, never released.
  450.  
  451.  
  452.  
  453. v4.6 (08/04/92)
  454.  
  455. Revised I/O routines to accomodate changes to several file formats.
  456.  
  457. Revised I/O routines for RBBS systems. Seems the format has been
  458. changed slightly when running local doors. Fixed problem, thanks to
  459. Rob Engle for his assistance with resolving this problem.
  460.  
  461. Added new option, "B" for all but a BUCK. Many times, users will want
  462. to bet almost all they have on a card (3,4,Q,K). This lets them bet all
  463. but $1 of their total bank.
  464.  
  465. Revised scoreboard, deleting average $ per play and replaced with # of
  466. plays and date last played. Helpful for users who are in competition
  467. with another user to know if they have played recently.
  468.  
  469. Changed display character for the club if in color mode. Seems that the
  470. Compuserve system uses that as their file transfer start character,
  471. users who had AUTO COMPUSERVE ON were getting +0+0's popping up when the
  472. club was displayed. The character selected isn't as "cute", but better
  473. than +0's being displayed.
  474.  
  475.  
  476. v5.0 (08/23/92)
  477.  
  478. Underwent a major upgrade in the I/O routines. This door now supports baud
  479. rates up to 115,200 and COM1-4 (plus non-standard IRQ's). This should help
  480. those who lock their baud rates at 38,400 and above. In addition, these new
  481. routines should allow the program to be run under DesqView. Please note, those
  482. who are upgrading from a prior version should review the new configuration
  483. file format. This door is now released as a completely stand-alone
  484. program, no longer requiring the BRUN45.EXE file.
  485.  
  486.  
  487. v5.1  (10/18/92)
  488.  
  489. Many ideas have been suggested for improving Card Sharks. I've taken
  490. several comments and implemented the following changes:
  491.  
  492. Added option to add a JOKER to the deck.
  493.  
  494. Added option to either BANKRUPT player or lose turns remaining for the
  495. day if Joker is hit.
  496.  
  497. Added option for sysop to include their own WINNING and LOSING comments
  498. in the file CS.TXT (registered version only)
  499.  
  500. Improvement in the screen displays.
  501.  
  502. Improved CHAT routine - now restores upon return.
  503.  
  504. Revised routines to not display scoreboard twice during replays.
  505.  
  506. Minor screen revisions.
  507.  
  508. Fixed problem with upper case input -  now accepts both upper and
  509. lower case input without a problem.
  510.  
  511.  
  512. |v5.2 (11/11/92)
  513. |
  514. |New support for FOSSIL drivers (see section on FOSSIL DRIVERS above for
  515. |details).
  516. |
  517. |Screen displays have again been optimized, screen displays are faster
  518. |than previous versions.
  519.  
  520.  
  521. DISTRIBUTION SITES:
  522.  
  523.    As always you can find the latest version of Card Sharks available for
  524.    downloading from Corporate Headquarters BBS.
  525.  
  526.    Calls for support for Card Sharks should be directed only to
  527.    Corporate Headquarters BBS.
  528.  
  529.    Corporate Headquarters BBS   (815) 886-3233  (14400 v.32bis)
  530.                                       886-9381  (14400 v.32bis)
  531.    TDS International Network    (503) 342-4447  (HST 14.4K)
  532.